Inside Macintosh: QuickDraw GX Objects /

Chapter 7 - View-Related Objects / View-Related Objects Reference

View Group Functions / Creating and Disposing of View Group Objects

GXNewViewGroup

You can use the GXNewViewGroup function to create a new view group object.

gxViewGroup GXNewViewGroup(void);

function result

A reference to the new view group.

DESCRIPTION

The GXNewViewGroup function returns a unique view group reference. You can then use the new view group to create view ports and view devices that share the same global space. QuickDraw GX provides an onscreen view group, gxScreenViewDevices, for you. You only need to create offscreen view groups.

SPECIAL CONSIDERATIONS

If no error occurs, the GXNewViewGroup function creates a view group object; you are responsible for disposing of that object when you no longer need it.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory

SEE ALSO

For examples of the use of this function, see Listing 7-13 on page 7-61 and Listing 7-14 on page 7-63.

For information about view groups, see "About View Group Objects" beginning on page 7-29.

To dispose of a view group, use the GXDisposeViewGroup function, described next.